home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
IRIX Base Documentation 1998 November
/
IRIX 6.5.2 Base Documentation November 1998.img
/
usr
/
share
/
catman
/
p_man
/
cat3
/
Xm
/
MrmFetchIconLiteral.z
/
MrmFetchIconLiteral
Wrap
Text File
|
1998-10-30
|
7KB
|
133 lines
MMMMrrrrmmmmFFFFeeeettttcccchhhhIIIIccccoooonnnnLLLLiiiitttteeeerrrraaaallll((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV MMMMrrrrmmmmFFFFeeeettttcccchhhhIIIIccccoooonnnnLLLLiiiitttteeeerrrraaaallll((((3333XXXX))))
NNNNAAAAMMMMEEEE
MMMMrrrrmmmmFFFFeeeettttcccchhhhIIIIccccoooonnnnLLLLiiiitttteeeerrrraaaallll - Fetches an icon literal from a
hierarchy
SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
#include <Mrm/MrmPublic.h>
CCCCaaaarrrrddddiiiinnnnaaaallll MMMMrrrrmmmmFFFFeeeettttcccchhhhIIIIccccoooonnnnLLLLiiiitttteeeerrrraaaallll(
MMMMrrrrmmmmHHHHiiiieeeerrrraaaarrrrcccchhhhyyyy hhhhiiiieeeerrrraaaarrrrcccchhhhyyyy____iiiidddd,
SSSSttttrrrriiiinnnngggg iiiinnnnddddeeeexxxx,
SSSSccccrrrreeeeeeeennnn ****ssssccccrrrreeeeeeeennnn,
DDDDiiiissssppppllllaaaayyyy ****ddddiiiissssppppllllaaaayyyy,
PPPPiiiixxxxeeeellll ffffggggppppiiiixxxx,
PPPPiiiixxxxeeeellll bbbbggggppppiiiixxxx,
PPPPiiiixxxxmmmmaaaapppp ****ppppiiiixxxxmmmmaaaapppp);
VVVVEEEERRRRSSSSIIIIOOOONNNN
This page documents Motif 2.1.
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
The MMMMrrrrmmmmFFFFeeeettttcccchhhhIIIIccccoooonnnnLLLLiiiitttteeeerrrraaaallllfunction fetches an icon literal from
an MRM hierarchy and converts the icon literal to an X
pixmap.
_h_i_e_r_a_r_c_h_y__i_d
Specifies the ID of the UID hierarchy that
contains the specified icon literal. The
_h_i_e_r_a_r_c_h_y__i_d was returned in a previous call to
MMMMrrrrmmmmOOOOppppeeeennnnHHHHiiiieeeerrrraaaarrrrcccchhhhyyyyPPPPeeeerrrrDDDDiiiissssppppllllaaaayyyy.
_i_n_d_e_x Specifies the UIL name of the icon literal to
fetch.
_s_c_r_e_e_n Specifies the screen used for the pixmap. The
_s_c_r_e_e_nargument specifies a pointer to the Xlib
structure SSSSccccrrrreeeeeeeennnn, which contains the information
about that screen and is linked to the
DDDDiiiissssppppllllaaaayyyystructure. For more information on the
DDDDiiiissssppppllllaaaayyyyand SSSSccccrrrreeeeeeeennnnstructures, see the Xlib function
XXXXOOOOppppeeeennnnDDDDiiiissssppppllllaaaayyyyand the associated screen information
macros.
_d_i_s_p_l_a_y Specifies the display used for the pixmap. The
_d_i_s_p_l_a_yargument specifies the connection to the X
server. For more information on the DDDDiiiissssppppllllaaaayyyy
structure, see the Xlib function XXXXOOOOppppeeeennnnDDDDiiiissssppppllllaaaayyyy.
_f_g_p_i_x Specifies the foreground color for the pixmap.
_b_g_p_i_x Specifies the background color for the pixmap.
_p_i_x_m_a_p Returns the resulting X pixmap value. The
function allocates space for this pixmap. The
Page 1 (printed 10/24/98)
MMMMrrrrmmmmFFFFeeeettttcccchhhhIIIIccccoooonnnnLLLLiiiitttteeeerrrraaaallll((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV MMMMrrrrmmmmFFFFeeeettttcccchhhhIIIIccccoooonnnnLLLLiiiitttteeeerrrraaaallll((((3333XXXX))))
application is responsible for managing the
allocated space. The application can recover the
allocated space by calling XXXXmmmmDDDDeeeessssttttrrrrooooyyyyPPPPiiiixxxxmmmmaaaapppp.
RRRREEEETTTTUUUURRRRNNNN
This function returns one of the following status return
constants:
MMMMrrrrmmmmSSSSUUUUCCCCCCCCEEEESSSSSSSS
The function executed successfully.
MMMMrrrrmmmmBBBBAAAADDDD____HHHHIIIIEEEERRRRAAAARRRRCCCCHHHHYYYY
The hierarchy ID was invalid.
MMMMrrrrmmmmNNNNOOOOTTTT____FFFFOOOOUUUUNNNNDDDD
The icon literal was not found in the hierarchy.
MMMMrrrrmmmmWWWWRRRROOOONNNNGGGG____TTTTYYYYPPPPEEEE
The caller tried to fetch a literal of a type not
supported by this function.
MMMMrrrrmmmmFFFFAAAAIIIILLLLUUUURRRREEEE
The function failed.
RRRREEEELLLLAAAATTTTEEEEDDDD
MMMMrrrrmmmmFFFFeeeettttcccchhhhBBBBiiiittttmmmmaaaappppLLLLiiiitttteeeerrrraaaallll(3), MMMMrrrrmmmmOOOOppppeeeennnnHHHHiiiieeeerrrraaaarrrrcccchhhhyyyyPPPPeeeerrrrDDDDiiiissssppppllllaaaayyyy(3),
MMMMrrrrmmmmFFFFeeeettttcccchhhhLLLLiiiitttteeeerrrraaaallll(3), MMMMrrrrmmmmFFFFeeeettttcccchhhhCCCCoooolllloooorrrrLLLLiiiitttteeeerrrraaaallll(3), and
XXXXOOOOppppeeeennnnDDDDiiiissssppppllllaaaayyyy(3).
Page 2 (printed 10/24/98)